home *** CD-ROM | disk | FTP | other *** search
/ In-To-The-Net / In-to-the-net (1996)(Weird Science)(Disc 1 of 2)[Amiga-PC].iso / tools / disksalv.doc < prev    next >
Text File  |  1996-01-25  |  45KB  |  1,072 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                 DDD  III SSSS K  K SSSS   A   L  V   V      222
  21.                 D  D  I  S    K K  S     A A  L  V   V         2
  22.                 D  D  I  SSSS KK   SSSS A   A L  V   V        2
  23.                 D  D  I     S K K     S AAAAA L  V   V       2
  24.                 D  D  I     S K  K    S A   A L   V V       2
  25.                 DDD  III SSSS K  K SSSS A   A LLLL V        2222
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.                     The Original Amiga Disk Salvage Program
  37.  
  38.  
  39.                    Recovering your data for over seven years
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.                                  Cheap Manual 
  51.                                      for 
  52.                                    DiskSalv 
  53.  
  54.                                    Version 2
  55.                                 Revision 11.25
  56.                                  June 13, 1993
  57.  
  58.                       Copyright 1992, 1993 by Dave Haynie
  59.                              All Rights Reserved 
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86. COPYRIGHT 
  87.  
  88.           This  manual  is  copyright  1992,  1993  by  Dave Haynie. All Rights
  89. Reserved.  As part of the DiskSalv2 V11.25 release, this manual may be used  in
  90. electronic or  printed  form  along  with the DiskSalv2 program.  It may not be
  91. sold  in  any  form,  though  a  reasonable  copying  and  handling  charge  is
  92. acceptable, as long as the complete DiskSalv2 distribution is included.  
  93.  
  94.  
  95. DISCLAIMER 
  96.  
  97.           The information and the DiskSalv program are provided "as is" without 
  98. warranty of  any  kind, either expressed or implied.  The entire risk as to the
  99. accuracy of the information herein is assumed by you.   Dave  Haynie  does  not
  100. warrant,  guarantee,  or  make any representations regarding the use of, or the
  101. results of the use of, the information or the  DiskSalv  program  in  terms  of
  102. correctness, accuracy,  reliability,  currentness,  or  otherwise.  In no event
  103. will Dave Haynie be liable for direct, indirect, incidental,  or  consequential
  104. damages  resulting  from  any defect in the information or the DiskSalv program
  105. even if he has been advised of the possibility of such damages.  
  106.  
  107.  
  108. CREDITS 
  109.  
  110.           This manual was prepared with anro, an nroff-like  utility  by  Steve
  111. Anderson.  With all the sophisticated word processors and DTPs I have around, I
  112. couldn't find anything that would simply give  me  some  formatted  ANSI  text.
  113. Until  everyone  has  a  way  to  deal with IFF-FTXT, ANSI will remain the only
  114. printer independent formatted text format available.  
  115.  
  116.           Amiga, AmigaDOS, Intuition, KickStart, and Workbench  are  trademarks
  117. of Commodore-Amiga, Inc.  
  118.  
  119.           The  DiskSalv program, its code, this manual, the DiskSalv icons, and
  120. anything else distributed with this package  are  the  original  work  of  Dave
  121. Haynie.  Thanks  go  out  to the Commodore-Amiga Software Engineering group for
  122. suggestions on the DiskSalv GUI and other Amiga software standards.   Countless
  123. others assisted with suggestions, testing, and miscellaneous feedback which has 
  124. also proved invaluable.  
  125.                                  -Dave Haynie
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149. DiskSalv Version 2 Release 11.25                                         Page 3
  150.  
  151.  
  152. 0. INTRODUCTION 
  153.  
  154.           DiskSalv  Version  2  is  a  disk recovery program for all Amiga file
  155. system devices that use any of the 2.04/2.1/3.0 file systems.    DiskSalv  will
  156. scan  (analyze)  a bad disk volume for anything that can be recovered, and will
  157. restore these items to any AmigaDOS volume.  It can also attempt to fix  a  bad
  158. volume in  place  under most circumstances.  DiskSalv is a complete redesign of
  159. the orignal DiskSalv program, with a  new  AmigaDOS-2.0-compliant  command-line
  160. interface, new Intuition interface, and tons of new features.  
  161.  
  162.           This  is  designed  to  be  a  fairly  complete,  quickly written and
  163. minimally edited manual of DiskSalv Version 2's features.   The  built-in  help
  164. system  works  as an adjunct to this, and it works simply -- press the HELP key
  165. with the mouse positioned over something,  and  a  short  description  of  that
  166. something will pop up in a requester.  
  167.  
  168.           Better documentation is planned, but it won't be free.  I'm currently 
  169. working  on  a professional quality manual with pictures, better "how to", "why
  170. bother", and "theory of it all" sections.  Of course, the operative phrase here 
  171. is "currently working".  It ain't done yet.  I hope to complete it by the  time
  172. I do  a  general  shareware  release.    Since  it will be several megabytes of
  173. PostScript output by the time its done,  and  I  really  have  no  philosphical
  174. objection to making a little beer money here and there, this will be offered up 
  175. as  a  printed manual as part of a semi-commercial version of DiskSalv. This is
  176. all explained in the "Licensing and Distribution" section.   Additionally,  the
  177. core  of  that manual will become an AmigaGuide manual, and that will come with
  178. the printed version.  I just figured I  would  mention  this  all  here  before
  179. confusing you with the quick and dirty version to follow.  
  180.  
  181.  
  182. 1. STARTING UP 
  183.  
  184.           DiskSav  Version  2  (from  here  on  referred to as "DiskSalv") is a
  185. program designed to "salvage" damaged hard disks.  There are two basic  classes
  186. of salvage operation, "Recover-by-Copy" and "Fix-in-Place". In the former case, 
  187. DiskSalv analyzes a disk and attempts to restore any files and directories from 
  188. a damaged  AmigaDOS  file  system  device  to  a good one.  In the latter case,
  189. DiskSalv attempts to find faulty disk objects and remove them from  the  disk's
  190. directory/file hierarchy so that the disk's FileSystem will validate it.  
  191.  
  192.  
  193. 1.1 CLI OPERATION 
  194.  
  195.           In  the  simplest  case, DiskSalv can be used very much like DiskSalv
  196. V1.42, the AmigaDOS "DiskCopy"  program,  or  any  number  of  other  CLI-based
  197. programs.  The user simply types a command at the command line, and the program 
  198. goes to  work.    For  example,  to  recover  files from a bad disk in DH0: and
  199. restore them on a good disk DH1:, the user will type: 
  200.  
  201.           1> DiskSalv FROM DH0: TO DH1: 
  202.  
  203. Here the "FROM" and "TO" required CLI keywords.  There are  quite  a  few  more
  204. keywords, which  control  a  good portion of DiskSalv's operation.  However, to
  205. access every feature, it's necessary to use  the  program  interactively  under
  206. Intuition. The AmigaDOS template is displayed as follows: 
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215. Page 4                                         DiskSalv Version 2 Release 11.25
  216.  
  217.  
  218.           DiskSalv Version 2 Copyright (c) 1991-1993 by Dave Haynie
  219.  
  220.           FROM/K, TO/K, MODE/K, FILESYSTEM/K, DEFAULTFS/K, TAGCHAR/K,
  221.           PUBSCREEN/K, MEMCHUNK/N, PATHMAX/N, DISKCACHE/N, LOWMEM/S,
  222.           NOSIZECHECK/S, QUICKSCAN/S, NOWARNING/S, NODATES/S, NONOTES/S,
  223.           NOPROTECT/S, KEEPDOS/S,KILLDOS/S, NODEEPSCAN/S, INTERACTIVE/S,
  224.           REJECTION/N, MAKELINKS/S,S MALLWINDOW/S, BIGBLOCKS/T
  225.  
  226. The meaning  of  these keywords is given below.  Note that any keyword can also
  227. be used as an icon variable (tooltype).  
  228.  
  229.      FROM 
  230.           The "FROM" keyword specifies an input device, the device that will be 
  231.           operated on.  This must be  a  DOS  device,  not  a  subdirectory  or
  232.           assignment,  and it must be based on one of the standard file systems
  233.           with underlying device driver.  
  234.  
  235.      TO 
  236.           The "TO" keyword specifies an output device,  the  device  that  will
  237.           receive any  recover-by-copy  files that DiskSalv finds.  This may be
  238.           any AmigaDOS device, volume, or  subdirectory.    If  a  non-existant
  239.           subdirectory is specified, one will be generated.  
  240.  
  241.      MODE 
  242.           There are  several  kinds  of  functions that DiskSalv will run.  The
  243.           default is "Salvage", which causes DiskSalv to  work  just  like  the
  244.           original DiskSalv. Other modes cause other actions: 
  245.  
  246.      SALVAGE 
  247.           This is  the  basic  Recover-by-Copy  function.  DiskSalv attempts to
  248.           restore every file it finds from  the  input  device  to  the  output
  249.           device.  The user can select the files to actually restore.  
  250.  
  251.      UNDELETE 
  252.           This is  another  Recover-by-Copy  function.  It is used on undamaged
  253.           partitions to find deleted files.  The user  can  interactively  pick
  254.           which files are actually restored in this way.  
  255.  
  256.      VALIDATE 
  257.           This is  the simplest Fix-In-Place function.  It can repair an device
  258.           that hasn't been severely damaged.  On most devices, the scan used in 
  259.           this mode is much faster than other scans, but it can  slow  down  on
  260.           very large  volumes.    As  with all Fix-In-Place functions, any file
  261.           that must be eliminated from disk will be displayed in  a  file  list
  262.           once the fix operation has completed.  
  263.  
  264.      REPAIR 
  265.           This is a more advanced Fix-In-Place function.  It does a traditional 
  266.           DiskSalv  scan, and it can find more files than the Validate function
  267.           can.  It can also live with partitions that  are  more  damaged  than
  268.           those Validate will handle.  
  269.  
  270.      UNFORMAT 
  271.           This  function  runs a Fix-In-Place operation on a disk that has been
  272.           accidently formatted (hopefully non-destructively).  It's similar  to
  273.           Repair, but it assumes that the disk root is invalid.  
  274.  
  275.      FILESYSTEM 
  276.  
  277.  
  278.  
  279.  
  280.  
  281. DiskSalv Version 2 Release 11.25                                         Page 5
  282.  
  283.  
  284.           This  allows  the user to specify the file system to use on the input
  285.           device.  Normally, DiskSalv will determine a partition's file  system
  286.           from its  root  block.    If  for  some  reason  that  information is
  287.           unavailable or  wrong,  this  allows  the  file  system  type  to  be
  288.           specified by force.  
  289.  
  290.                OFS 
  291.                     Original AmigaDOS FileSystem.  
  292.  
  293.                FFS 
  294.                     1.3-compatible Fast FileSystem.  
  295.  
  296.                OFS Intl.  
  297.                     International   character   set   aware   version  of  OFS.
  298.                     International file  systems  treat  diacritical  characters
  299.                     properly  with respect to the case independence expected in
  300.                     an Amiga file system.  
  301.  
  302.                FFS Intl.  
  303.                     International character set aware version of FFS.  
  304.  
  305.                DC-OFS 
  306.                     Directory caching version of OFS.  Directory  caching  file
  307.                     systems  keep  a  secondary  packed  record of file data to
  308.                     provide fast directory listings.  
  309.  
  310.                DC-FFS 
  311.                     Directory caching version of FFS.  
  312.  
  313.                Best-Guess 
  314.                     DiskSalv will pick one of the FileSystems it  knows  about,
  315.                     based on an analysis of the disk done during the Scan. This 
  316.                     is  the  standard  default  file  system (eg, default if no
  317.                     alternate default is selected).  
  318.  
  319.      DEFAULTFS 
  320.           This allows the user to specify the fallback FileSystem to use on the 
  321.           input device.    Normally,  DiskSalv  will  determine  a  partition's
  322.           FileSystem  from  its  root block, but if that root block is damaged,
  323.           DiskSalv needs this fallback.  
  324.  
  325.      TAGCHAR 
  326.           This allows the user to specify which character to  use  for  tagging
  327.           selected files  on  the  Output  screen file browser.  The default is
  328.           '*'.  
  329.  
  330.      PUBSCREEN 
  331.           This specifies the public screen for DiskSalv to start  up  on.    If
  332.           none  is  specified,  DiskSalv  will start up on the Workbench screen
  333.           (eg, default public screen).  
  334.  
  335.      MEMCHUNK 
  336.           This specifies the memory chunk size for DiskSalv's chunky  allocator
  337.           to use.  By default, this is 4K, and can be set between 1K and 128K.  
  338.  
  339.      PATHMAX 
  340.           This specifies  the maximum length of a file path.  The default value
  341.           is 512 bytes, and can be set between 256 bytes and 4K.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347. Page 6                                         DiskSalv Version 2 Release 11.25
  348.  
  349.  
  350.      DISKCACHE 
  351.           This specifies the number of blocks to be used  for  the  disk  cache
  352.           (which is  actually  a  pre-fetch  buffer).    The  default size is 8
  353.           blocks, and can be set between 0 (no cache) and 255 blocks.  
  354.  
  355.      LOWMEM 
  356.           This specifies low-memory mode.  If DiskSalv runs out of memory on  a
  357.           system in normal mode, it may be successful in low-memory mode.  This 
  358.           automatically causes the chunky allocator, file path buffer, and disk 
  359.           cache to go to minimum sizes.  It cuts out a number of other internal 
  360.           things that generally just affect performance rather than success.  
  361.  
  362.      NOSIZECHECK 
  363.           This   inhibits   automatic  size  checking  of  the  output  volume.
  364.           Normally, DiskSalv watches the size of the output volume to  have  an
  365.           idea ahead of time that a volume will fill up.  Some devices, such as 
  366.           RAM:,  are  dynamically sized and always indicate full when asked, so
  367.           this parameter is mainly intended for such devices (DiskSalv actually 
  368.           invokes this  automatically  for  RAM:,  but  it  would  have  to  be
  369.           specified manually for other such devices).  
  370.  
  371.      QUICKSCAN 
  372.           This specifies a faster disk scanning mode.  The speed of a disk scan 
  373.           is improved  by  cutting  down  on the visual display.  DiskSalv will
  374.           still show a "gas-guage" indicator, but it won't list objects as they 
  375.           are encountered.  
  376.  
  377.      NOWARNING 
  378.           DiskSalv will normally attach  a  warning  or  error  message,  as  a
  379.           FileNote,  to  any  file  it restores via a Recover-by-Copy operation
  380.           that it considers suspect or bad.   This  option  will  inhibit  such
  381.           action.  
  382.  
  383.      NODATES 
  384.           This  option  will  inhibit  restoration of the original file date in
  385.           Recover-by-Copy operations.  
  386.  
  387.      NONOTES 
  388.           This option will inhibit restoration  of  the  original  FileNote  in
  389.           Recover-by-Copy   operations  (though  warning  notes  will  override
  390.           original notes).  
  391.  
  392.      NOPROTECT 
  393.           This option will inhibit restoration of the original protection codes 
  394.           in Recover-by-Copy operations.  
  395.  
  396.      KEEPDOS 
  397.           The FileSystem (eg, AmigaDOS) is usually locked out  from  the  input
  398.           device during scan and recovery operations.  This option will prevent 
  399.           such a lockout.  Fix-In-Place operations are not affected by this, as 
  400.           they absolutely require a FileSystem lockout since they are modifying 
  401.           the input  disk.    Note  that  allowing any writes to the input disk
  402.           during a DiskSalv operation will almost certainly cause  DiskSalv  to
  403.           malfunction.  
  404.  
  405.      KILLDOS 
  406.           This  option  forces  DiskSalv to do its job without using any device
  407.           directed DOS functions or file system packets.    Normally,  DiskSalv
  408.  
  409.  
  410.  
  411.  
  412.  
  413. DiskSalv Version 2 Release 11.25                                         Page 7
  414.  
  415.  
  416.           uses a  handfull  of  DOS  library functions on input disks.  This is
  417.           designed to make DiskSalv safe for use on disks that  crash  AmigaDOS
  418.           or the  particular  file system in use.  This is a somewhat dangerous
  419.           option, since it prevents DiskSalv from locking the file  system  out
  420.           of a  device  (since  that  requires a file system packet).  It works
  421.           best on devices that can't be given to AmigaDOS because  they're  too
  422.           damaged.   Note  that  DOS  is  automatically  avoided  on  unmounted
  423.           devices.  
  424.  
  425.      NODEEPSCAN 
  426.           This inhibits extra  low-level  processing  from  being  done  floppy
  427.           disks.   Such  processing  can  recover  data not normally accessable
  428.           through the trackdisk.device, but it causes extra memory to be used.  
  429.  
  430.      INTERACTIVE 
  431.           This forces DiskSalv into interactive operation  (eg,  it  waits  for
  432.           user input).    When run from the CLI, DiskSalv will by default do as
  433.           much as it can non-interactively before going into interactive mode.  
  434.  
  435.      REJECTION 
  436.           This specifies a filter strength, between 1 and 10,  that  influences
  437.           DiskSalv's  assessment  of  whether  or  not  a  disk block matches a
  438.           specific block type.  This is generally left at the default, 6.  
  439.  
  440.      MAKELINKS 
  441.           This causes DiskSalv to actually create links on the  output  volume.
  442.           Normally  it  instead  creates  a  script  file which will create the
  443.           links.  
  444.  
  445.      SMALLWINDOW 
  446.           This causes DiskSalv to build a minimal scanning display window, even 
  447.           on large screens.  
  448.  
  449.      BIGBLOCKS 
  450.           This lets the user specifiy whether support for multiple sectors  per
  451.           block is  enabled.    On  pre-V39  systems,  occasionally DOS devices
  452.           claimed for some reason to have  more  than  one  sector  per  block.
  453.           Since  real  support  of this didn't appear until the V40 FileSystem,
  454.           which apparently needs V39 to run, multiple sector per block  support
  455.           is  off  by  default  in  on  a pre-V39 system, on by default for V39
  456.           systems and above.  
  457.  
  458.  
  459. 1.2 WORKBENCH OPERATION 
  460.  
  461.           DiskSalv can be run from the  Workbench  by  double-clicking  on  its
  462. Icon.  Normally,  this  brings up DiskSalv interactively, where options are set
  463. via standard 2.0-level Intuition  interface  objects.    However,  any  of  the
  464. command-line  parameters  may  be  set as Icon ToolTypes to set DiskSalv up for
  465. other-than-standard default conditions and other special things.  
  466.  
  467.  
  468. 1.3 THE DISKSALV GUI 
  469.  
  470.           No matter how you enter DiskSalv, you're going to wind up seeing some 
  471. aspect of the program's GUI. If you run interactively either from  the  CLI  or
  472. from Workbench, you will start out in the "Input Window". Here is where various 
  473. parameters  are set that control how the program will "scan", or learn about, a
  474.  
  475.  
  476.  
  477.  
  478.  
  479. Page 8                                         DiskSalv Version 2 Release 11.25
  480.  
  481.  
  482. given input disk.  Once all input information is set up, the program  moves  to
  483. the  "Scan  Window",  which  basically  monitors  disk  scan  and  Fix-In-Place
  484. operation, where applicable.   If  it's  appropriate  (files  are  found  in  a
  485. Recover-by-Copy   mode  or  damaged  files  are  found  during  a  Fix-In-Place
  486. operation), the Scan Window will give way to the "Output Window". This  windows
  487. accepts  input  to  select  the objects that will be restored and the device to
  488. restore them to.  
  489.  
  490.           While DiskSalv's interface is based on Intuition, there are  keyboard
  491. equivalents for  practically  anything you can do from gadgets or windows.  The
  492. gadget shortcuts are generally indicated by an inderlined letter in the text of 
  493. the particular gadget, and will change from language to language.  For  gadgets
  494. that  cycle  or  scroll, the direction of movement will change based on whether
  495. the shortcut is typed with the shift key pressed.  A few windows  have  gadgets
  496. with extra  functions  or non-text gadgets that have keyboard shortcuts.  Those
  497. shortcuts are mentioned in the this manual in the particular  section  relating
  498. to that gadet.  
  499.  
  500.           Menus also have keyboard shortcuts, which are always invoked with the 
  501. right Amiga  key  and a single letter pressed together.  These are indicated in
  502. the menus, in the normal Intuition fashion.  Note that these, too,  can  change
  503. according  to  the  localization  of  the  program, so the actual values aren't
  504. called out here.  
  505.  
  506.  
  507. 2.0 THE INPUT WINDOW 
  508.  
  509.           The Input Window is where a device is selected.  There are  a  series
  510. of gadgets  and  menu  items  that  can  control the way things work here.  The
  511. gadgets are as follows: 
  512.  
  513.      Device For Scan 
  514.           This list gadget displays a list of  recoverable  devices.    One  of
  515.           these must  be  selected  to  run  a  scan.   These are all listed by
  516.           physical AmigaDOS name, never by volume or assigned name.  
  517.  
  518.      FileSystem: 
  519.           This  gadget  is  a  cycle  gadget  that  allows  any  of   the   six
  520.           aforementioned file  systems  to  be  selected.    When  you select a
  521.           device, this gadget will be set to  DiskSalv's  best  guess  at  that
  522.           device's  file  system,  or the default if DiskSalv can't make a good
  523.           guess.  Therefore, the user is  able  to  pick  a  different  one  if
  524.           DiskSalv didn't  make  a good choice.  See section 1.1, "FILESYSTEM",
  525.           for a list  of  these.    The  "Best-Guess"  option  runs  a  special
  526.           statistics tracking and analysis routine to determine the most likely 
  527.           file system for any given device.  
  528.  
  529.      Mode: 
  530.           This  cycle  gadget  lets  the  user  select  an appropriate recovery
  531.           operation.  Interlocks are managed here  to  make  certain  that  the
  532.           specified operation  and  specified  device  will work together.  See
  533.           section 1.1, "MODE", for a list of the FileSystem names.  
  534.  
  535.      Set Filter...  
  536.           This gadget brings up the "Disk Scan Filter Options"  window.    This
  537.           window allows various options to be set to control partial scans of a 
  538.           disk,  exclusions  by  AmigaDOS pattern name or protection bits, etc.
  539.           See section 2.1 for a full explanation of this window.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545. DiskSalv Version 2 Release 11.25                                         Page 9
  546.  
  547.  
  548.      Device Info...  
  549.           This gadget brings up a "Physical Device Information" requester which 
  550.           gives partitioning and other low-level information  on  the  selected
  551.           device.  
  552.  
  553.      Scan 
  554.           This  gadget  starts the disk analysis phase of the DiskSalv program.
  555.           Once the other phases are complete, the user may return to the  Input
  556.           Window without having to restart DiskSalv.  
  557.  
  558.           There  are  two menus on the Input Window. One of these can call up a
  559. variety of miscellaneous functions,  the  other  controls  toggling  of  a  few
  560. control options,  and the ability to save these back to the DiskSalv icon.  The
  561. mens are as follows: 
  562.  
  563.      Project/About...  
  564.           This item brings up a requester with information on  the  version  of
  565.           DiskSalv, its distribution license, some Shareware data, and where to 
  566.           write me about DiskSalv.  
  567.  
  568.      Project/Help...  
  569.           This item brings up a requester with a brief explanation of the Input 
  570.           Window.  
  571.  
  572.      Project/Log File...  
  573.           This  item  brings up a file requester for the specification of a log
  574.           file.  This file must be on a device other  than  the  input  device.
  575.           When  a  log  file  is specified, DiskSalv will write a record of its
  576.           activity during all phases out to that file.  
  577.  
  578.      Project/Restore...  
  579.           This item brings up the "Stream Restoration Options" requester, which 
  580.           allows the user to specify input and output paths for restoration  of
  581.           a DiskSalv  archive  file.    Please see section 3 for information on
  582.           creating DiskSalv archive files.  
  583.  
  584.      Project/Custom...  
  585.           This item brings up the "Custom Window".  The  Custom  Window  is  an
  586.           advanced  option  that  can  be  used  to  search  a disk for logical
  587.           partitions or specify partitions based on the low-level components.  
  588.  
  589.      Project/Save Device...  
  590.           This item saves  the  currently  selected  "Device  for  Scan"  as  a
  591.           description file for the AmigaDOS Mount command.  
  592.  
  593.      Project/Load Device...  
  594.           This  item  loads  a  specified AmigaDOS device description file as a
  595.           DiskSalv "virtual" device.  The name of the device will be  the  name
  596.           of the description file.  
  597.  
  598.      Project/Quit 
  599.           This item  closes the DiskSalv program.  Its function is identical to
  600.           that of the Close gadget on the DiskSalv main window.  
  601.  
  602.      Settings/DOS Lock 
  603.           The FileSystem (eg, AmigaDOS) is usually locked out  from  the  input
  604.           device during  scan  and  recovery  operations.   This option toggles
  605.           prevention of such  a  lockout.    Fix-In-Place  operations  are  not
  606.  
  607.  
  608.  
  609.  
  610.  
  611. Page 10                                        DiskSalv Version 2 Release 11.25
  612.  
  613.  
  614.           affected  by  this,  as they absolutely require a file system lockout
  615.           since they are modifying the input disk.    Note  that  allowing  any
  616.           writes  to  the  input  disk  during a DiskSalv operation will almost
  617.           certainly cause DiskSalv to malfunction.  
  618.  
  619.      Settings/Low Memory 
  620.           This option toggles low-memory mode.  If DiskSalv runs out of  memory
  621.           on  a system in normal mode, it may be successful in low-memory mode.
  622.           This automatically causes the chunky allocator, file path buffer, and 
  623.           disk cache to go to minimum sizes.  It cuts out  a  number  of  other
  624.           internal  things  that  generally just affect performance rather than
  625.           success.  
  626.  
  627.      Settings/Small Window 
  628.           This option toggles automatic window sizing.  Normall,  the  DiskSalv
  629.           scanner  will  open  a  large  window  if it finds the current screen
  630.           supports it.  This will force use of the small window for all  scans,
  631.           regardless of the screen size.  
  632.  
  633.      Settings/Quick Scan 
  634.           This option  selects the quick scanning option for the scanner.  With
  635.           this set, the scanning process will run faster by not displaying  any
  636.           data on the files encountered.  
  637.  
  638.      Settings/Save Settings 
  639.           This  options  saves  various  Input screen variables to the DiskSalv
  640.           tools icon.  
  641.  
  642.  
  643. 2.1 THE DISK SCAN FILTER OPTIONS WINDOW 
  644.  
  645.           The "Disk Scan Filter Options" window allows several modifiers to  be
  646. set that  affect  the  scan  phase  of  a  Recover-by-Copy  operations.   These
  647. modifiers are ignored by Fix-In-Place operations, which must examine a disk  in
  648. its entirety  to  perform correctly.  The window has standard "Ok" and "Cancel"
  649. gadgets, which use  and  ignore  the  effect  of  the  current  filter  options
  650. settings, respectively.  The other gadgets are as follows: 
  651.  
  652.      File Pattern 
  653.           The string gadget takes in an AmigaDOS file pattern.  During the scan 
  654.           of a disk, any file matching this pattern is recorded, while any file 
  655.           not matching  is  ignored.   This acts on links as well as files, but
  656.           not on directories, since at the time a directory is scanned, there's 
  657.           no way to tell if it will be needed by a child object that's  further
  658.           into the disk.  
  659.  
  660.      Disk Scan Range 
  661.           This gadget is composed of two pointers, which can be moved to modify 
  662.           the part  of  the input disk that is actually scanned.  The start and
  663.           finishing blocks on that disk are indicated next to the gadget.   The
  664.           gadget  is  hard-wired  to make certain that the start of the disk is
  665.           below the finish.  This can be moved from the keyboard with left  and
  666.           right cursor keys, unshifted or shifted.  
  667.  
  668.      Protection Bits 
  669.           This  is  a  group  of  gadgets  which  control matching of each file
  670.           encountered against the seven defined  protection  bits.    A  "Don't
  671.           Care"  setting matches any level, a "Match Set" setting matches a bit
  672.  
  673.  
  674.  
  675.  
  676.  
  677. DiskSalv Version 2 Release 11.25                                        Page 11
  678.  
  679.  
  680.           that's logically set, and a  "Match  Clear"  setting  matches  a  bit
  681.           that's logically clear.  
  682.  
  683.  
  684. 2.2 THE CUSTOM WINDOW 
  685.  
  686.           The  Custom  Window is a fork off the main DiskSalv Input Window that
  687. is used for dealing with special device cases.  An unknown disk,  a  disk  with
  688. lost partitioning  information,  or other such problems can be solved here.  An
  689. input device is entered via exec-level device name and unit number.   The  user
  690. can  specify  the  partitioning  information  or ask DiskSalv to go looking for
  691. partitions.  In a search, the partition's logical name can be  specified  as  a
  692. search  target,  or  DiskSalv  can  be instructed to find all partitions on the
  693.           disk.  There are fifteen gadgets here: 
  694.  
  695.      Create 
  696.           The  Create  gadget  builds  one  "virtual  device"  based   on   the
  697.           information supplied  here.    This  requires  the basic partitioning
  698.           information, exec device name and unit, and a DOS Name which is  used
  699.           in the  "Device  For  Scan"  list gadget.  Any such virtual device is
  700.           listed in parentheses, and only the "Salvage" operation can  be  used
  701.           on them.  
  702.  
  703.      Search 
  704.           This  function  starts a search on the given disk for one volume that
  705.           matches the given pattern.  
  706.  
  707.      Analyze 
  708.           This function starts a scan of the defined range of the disk for  any
  709.           partitions.   The  base block of a partition will be used as its name
  710.           if no root is found.  If a root is  found,  its  name  will  be  used
  711.           instead in the "Device For Scan" list.  
  712.  
  713.      Cancel 
  714.           Leave this window without performing any kind of scan.  
  715.  
  716.      Device Name: 
  717.           This   is   the  Exec  device  used  to  manage  the  disk,  such  as
  718.           "scsi.device".  Be very careful in selecting this properly.  
  719.  
  720.      Name/Pattern: 
  721.           This is a DOS Name for "Created" volumes, or a pattern to apply to  a
  722.           search  for  a  specific  volume  or as a volume-name filter for full
  723.           analysis.  
  724.  
  725.      Unit: 
  726.           The unit number for the Exec device names in "Device Name".  Be  very
  727.           careful in selecting this properly.  
  728.  
  729.      Sectors/Track: 
  730.           This is the number of sectors assigned per disk track.  
  731.  
  732.      Bytes/Sector: 
  733.           This is  the  basic  block size for the device.  While most things in
  734.           the system are set up for 512  byte  blocks,  larger  disks  may  use
  735.           larger block  sizes.    These  are  in  powers-of-two,  512  bytes or
  736.           larger.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743. Page 12                                        DiskSalv Version 2 Release 11.25
  744.  
  745.  
  746.      Sectors/Block: 
  747.           This parameter  allows  for  a  variable  effective  block  size  per
  748.           partition while having a consistent number of bytes/sector throughout 
  749.           a disk.  Block size is Sectors/Block * Bytes/Sector. By default, this 
  750.           is only available under V39 or later file systems.  
  751.  
  752.      Low Sector: 
  753.           This  is  the  starting  position on the input device to be searched.
  754.           Since we're not searching a logical partition but in fact a  physical
  755.           disk,  this number is a direct disk sector number (this specifies the
  756.           physical block to map to logical block 0 for the Create operation).  
  757.  
  758.      High Sector: 
  759.           This is the last physical block to scan for all operations.  
  760.  
  761.      Flags: 
  762.           These are device-driver specific flags.  
  763.  
  764.      Memory Type: 
  765.           This cycle gadget allows the user to specify the type  of  memory  to
  766.           use for  disk  buffers.    Types  include  DEFAULT,  CHIP,  FAST, and
  767.           DMA-24.  
  768.  
  769.           There are only two menu items on the  single  menu  attached  to  the
  770. Custom  Window.  The  first  is  the  "Project/Help..."  item,  which pops up a
  771. requester box describing the Custom Window. The other item  is  "Project/Quit",
  772. which will terminate the DiskSalv program.  
  773.  
  774.  
  775. 3. THE SCAN WINDOW 
  776.  
  777.           The  Scan Window is entered once the user selected the Scan gadget of
  778. the Input Window. In normal operation, the Scan window will have  two  gadgets,
  779. two menu  items, and four informational displays.  The "Stop" gadget will cause
  780. the scan to stop where it is.   This  is  only  available  for  Recover-by-Copy
  781. operations, since  Fix-In-Place  operations  need to scan the entire disk.  The
  782. other gadget is the "Pause" gadget, which will freeze  the  scan  where  it  is
  783. until told to go on.  
  784.  
  785.           The  two  menu  items  are  "Project/Help..." and "Project/Quit". The
  786. former will display some information about the Scan Window,  while  the  latter
  787. will  cause  the  DiskSalv  program  to  quit, just like the Close gadget will.
  788. During Fix-In-Place operations, the  Quit  function  will  take  some  time  if
  789. invoked during some of the latter fixing phases, since DiskSalv doesn't want to 
  790. leave the disk in a questionable state.  
  791.  
  792.           The  "Current  Operation" display indicates what DiskSalv is actually
  793. doing at any given time during the scan.  To the right of this is  the  "Device
  794. Scan" box, which keeps track of scanning statistics, like the current block and 
  795. number of  Files  or Errors encountered.  Below this is the "fuel guage", which
  796. is always used to indicate the progress of the current phase.   Below  that  is
  797. the  "Scanning  Results"  display,  which  indicates  the type and name of each
  798. object found, as well as other statistics (this is basically what gets  written
  799. out to  the  log  file,  if  there is a log file).  On a large display, this is
  800. eleven lines long, on a small display its  five  lines  long.    The  QUICKSCAN
  801. option eliminates this part of the display altogether.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809. DiskSalv Version 2 Release 11.25                                        Page 13
  810.  
  811.  
  812. 4. THE OUTPUT WINDOW 
  813.  
  814.           All  Recover-by-Copy  operations  and  Fix-In-Place  operations  with
  815. corrupt files end the scanning process and open  the  Output  Window.  This  is
  816. where   objects   and   the  output  path  are  selected  for  a  Restore  (eg,
  817. Recover-by-Copy) operation.  This window's GUI consists of twelve  gadgets  and
  818. ten menu items.  The gadgets are as follows: 
  819.  
  820.      Salvage File List (etc) 
  821.           The  scrolling  file  list,  labelled  somewhat  differently for each
  822.           function, is where files  are  selected  for  restoration  to  a  new
  823.           volume.   Clicking  on a file or link alternately tags or clears that
  824.           object, and makes it the "current"  object  (displayed  in  the  text
  825.           gadget below the list gadget).  Clicking on a directory once makes it 
  826.           the current object, but does not tag it.  Clicking again on that same 
  827.           directory causes  this  "browser" to "move" to that directory.  There
  828.           are keyboard shorts for this too.  The standard gadget  short  (shown
  829.           in  the  list  title), will scroll the selected item in the list, but
  830.           won't actually do anything with  it.    The  space  bar  will  toggle
  831.           selection of file objects, or enter directories.  
  832.  
  833.      Output Path 
  834.           This  specifies  two gadgets, a disk icon gadget and a string gadget.
  835.           Clicking on the disk icon brings up a file requester, while  clicking
  836.           on the  string  requester  lets  the user enter a path by hand.  This
  837.           path is the place to put any recovered files.  It can  be  a  device,
  838.           directory,  or  possibly  a "stream", depending on the setting of the
  839.           "Archive Stream" option.  If a non-existant directory  is  specified,
  840.           it is created.  
  841.  
  842.      Salvage 
  843.           This gadget  begins  the  file  restoration.   It won't be selectable
  844.           until at least something is tagged in the  Salvage  List  and  proper
  845.           output device parameters have been entered.  
  846.  
  847.      File List Action 
  848.           The remaining  gadgets are part of the File List Action group.  These
  849.           control tags on objects, browser navigation, and other aspects of the 
  850.           file list.  Note that only tagged files are operated on  by  "Forget"
  851.           or "Salvage".  
  852.  
  853.      Parent 
  854.           This gadget brings the file browser up by one directory level.  
  855.  
  856.      Root 
  857.           This gadget brings the file brower up to the top directory level.  
  858.  
  859.      Forget 
  860.           This gadget removes any tagged objects from the browser list.  It has 
  861.           no effect on the object as it exists on-disk.  
  862.  
  863.      Info...  
  864.           Statistics  on the "current" object are displayed in a requester when
  865.           this is selected.  
  866.  
  867.      Select Directory 
  868.           This will  recursively  tag  every  object  in  the  hierarchy  of  a
  869.           directory.   If  the  current  object  is  a  directory,  it's  used,
  870.  
  871.  
  872.  
  873.  
  874.  
  875. Page 14                                        DiskSalv Version 2 Release 11.25
  876.  
  877.  
  878.           otherwise the present (displayed) directory is used.  
  879.  
  880.      Select Files 
  881.           Like "Select Directory", but tags only files.  
  882.  
  883.      Clear Directory 
  884.           Like "Select Directory", but recursively untags objects.  
  885.  
  886.      Clear Files 
  887.           Like "Clear Directory", but untags only files.  
  888.  
  889.           Most of the menu items  are  designed  to  support  the  settings  of
  890. different restore-time parameters.  The menu items are: 
  891.  
  892.      Project/Help...  
  893.           This option pops up with a brief description of the Output window.  
  894.  
  895.      Project/New Device...  
  896.           This  option  resets  DiskSalv  and  starts  over  back  at the Input
  897.           Window.  
  898.  
  899.      Project/Quit 
  900.           This option, like the close gadget, causes DiskSalv to cleanly exit.  
  901.  
  902.      Settings/Size Check 
  903.           This toggles automatic size checking of the output volume.  Normally, 
  904.           DiskSalv watches the size of the output volume to have an idea  ahead
  905.           of time  that a volume will fill up.  Some devices, such as RAM:, are
  906.           dynamically sized and  always  indicate  full  when  asked,  so  this
  907.           parameter  is  mainly  intended  for  such devices (DiskSalv actually
  908.           invokes this  automatically  for  RAM:,  but  it  would  have  to  be
  909.           specified manually for other such devices).  
  910.  
  911.      Settings/Warning Notes 
  912.           This  toggles  whether or not DiskSalv will attach a warning or error
  913.           message, as a FileNote, to any file it restores via a Recover-by-Copy 
  914.           operation that it considers suspect or bad.  
  915.  
  916.      Settings/Notes Restored 
  917.           This toggles  restoration  the  original  FileNote  to  any  restored
  918.           object.  Warning  notes  will  override original notes).  This option
  919.           will inhibit such an action.  
  920.  
  921.      Settings/Protection Restored 
  922.           This toggles restoration of the  original  protection  codes  on  any
  923.           object.  This option will inhibit such an action.  
  924.  
  925.      Settings/Date Restored 
  926.           This  toggles restoration of the original AmigaDOS date to all output
  927.           objects.  
  928.  
  929.      Settings/Archive Stream 
  930.           This determines which I/O formation is used for  the  output  device.
  931.           By   default,   the  OUTPUT  device  is  a  directory,  and  DiskSalv
  932.           regenerates the specified directory tree as found on the input  disk.
  933.           When  Archive Stream mode is set, DiskSalv writes out everything in a
  934.           structured output stream.  This stream is turned back to a  directory
  935.           tree  by  using the Project/Restore option on the Input Window. Since
  936.  
  937.  
  938.  
  939.  
  940.  
  941. DiskSalv Version 2 Release 11.25                                        Page 15
  942.  
  943.  
  944.           this formatted stream makes all disk objects appear as a single file, 
  945.           it can be piped though compression tools and processed through  other
  946.           interesting programs as desirable.  
  947.  
  948.      Settings/Save Settings 
  949.           When  selected, this saves the state of the toggle options other than
  950.           "Archive Stream" out to the DiskSalv.info file.  
  951.  
  952.  
  953. 5. THE RECOVERY WINDOW 
  954.  
  955.           The Recovery Window  looks  exactly  like  the  Scan  window,  mainly
  956. because it  is the Scan Window just doing something else.  This window displays
  957. each file as it's restored to the output device.  Along the way, if the  output
  958. device  fails  or  gets  full,  DiskSalv will prompt the user to skip the file,
  959. change the media, or change devices.  When a device change  is  requested,  the
  960. Output  window  is called up again to secure a new device input the normal way.
  961. At that point, only files left yet-to-be restored will be out on disk.  
  962.  
  963.  
  964. 6. LICENSING AND DISTRIBUTION 
  965.  
  966.           This  program  is  distributed  as  ShareWare.  It  may   be   freely
  967. redistributed,  but  no charges other than reasonable copying and handling fees
  968. may be collected.  The suggested basic registration fee is  US$10,  which  gets
  969. you an entry in my database of users.  
  970.  
  971.           The  semi-commercial version is available for US$40 (release expected
  972. in August of 1993), and it comes with a professional quality manual, AmigaGuide 
  973. manual, and the latest version of DiskSalv on  disk  as  well,  along  with  an
  974. update when  ready.    At present, the commercial and shareware versions of the
  975. program are the same, though at any given point, the commercial version will of 
  976. course be the very latest release available.  
  977.  
  978.           Finally, if you want an  update  service,  for  an  additional  US$10
  979. (US$15 foreign)  you  get  a  year's worth of updates, at least two.  If no bug
  980. fixes are done during that time, you'll get an  enhanced  version  when  it  is
  981. released.   This  is mainly to keep those concerned about any bugs fed with the
  982. latest version automatically.  
  983.  
  984.           The place to send any and all inquirys, bug reports, etc.  is: 
  985.                     Dave Haynie
  986.                     284 Memorial Avenue
  987.                     Gibbstown, NJ 08027
  988.                     USA
  989.  
  990.                     You can also contact me electronically:
  991.                               UUCP:    daveh@cbmvax.commodore.com
  992.                               Usenet:    {uunet,rutgers}!cbmvax!daveh
  993.                               BIX:        hazy
  994.                               Portal:        hazy
  995.                               FAX:        +1 (609)224-0442
  996.  
  997.           If you're not from the USA, you can pay in your local currency if you 
  998. send a cash equivalent.  The extra expense  of  you  getting  a  draft  for  US
  999. currency,  then  me  paying  the  bank for collection, seems to leave the banks
  1000. getting about 1/2 the money for a US$10 registration fee.   I'd  just  as  soon
  1001. convert the cash myself once I collect a reasonable amount.  Of course, if your 
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007. Page 16                                        DiskSalv Version 2 Release 11.25
  1008.  
  1009.  
  1010. country's  laws  prohibit sending cash out of the country or something similar,
  1011. you may not want to do this.  
  1012.  
  1013.           Also  of  interest  to  foreign  Amiga  users  is  language  support.
  1014. DiskSalv fully  supports the AmigaDOS 2.1 localization library mechanism.  Some
  1015. locale catalogs are included with this  initial  release.    Additional  locale
  1016. support should  be  available  at a later date.  Translations of the commercial
  1017. manual may be possible, but none are currently being developed.  
  1018.  
  1019.           If  you're  a  commercial  interest,  you  can   contact   me   about
  1020. non-exclusive bundling  deals  if  you're  interested.  Dealers or other groups
  1021. should contact me about volume discounts on the deluxe distribution.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.